========================================================
   CLUB PLANNER - eID LEZEN OP MAC
   Installatiehandleiding
========================================================

WAT IS DIT?
-----------
Dit installeert een klein hulpprogramma waardoor Club Planner (in Google
Chrome) een Belgische eID-kaart kan uitlezen via de kaartlezer.
Je hoeft NIETS anders te installeren (geen extra software, geen internet
nodig tijdens de installatie).


WAT HEB JE NODIG?
-----------------
- Een Mac (Apple Silicon of Intel - het script kiest zelf het juiste).
- Google Chrome, met de Club Planner-extensie al geinstalleerd
  (die staat er normaal al op - je hoeft daar niets voor te doen).
- Een USB-kaartlezer voor de eID.


INSTALLEREN - 4 STAPPEN
-----------------------

STAP 1 - Map naar de Mac kopieren
   Kopieer deze VOLLEDIGE map (met alle bestanden erin) naar de Mac,
   bijvoorbeeld naar het Bureaublad. Niet losse bestanden - de hele map.

STAP 2 - Installatie starten
   Dubbelklik op het bestand:  installeer.command

   Zegt de Mac "kan niet geopend worden omdat het van een
   niet-geidentificeerde ontwikkelaar is"?
   -> Doe dan EENMALIG dit:
      1. Rechtermuisklik (of Ctrl + klik) op  installeer.command
      2. Kies  Open
      3. Klik in het venstertje nogmaals op  Open
   Vanaf dan werkt gewoon dubbelklikken.

   Op een NIEUWERE Mac (macOS 15 "Sequoia" of later) bestaat die
   rechtermuisklik-truc niet meer. Doe dan dit:
      1. Dubbelklik installeer.command (de Mac weigert - dat is normaal)
      2. Open  Systeeminstellingen  >  Privacy en beveiliging
      3. Scrol naar onderen: daar staat een melding over installeer.command
         met de knop  "Open toch"  (Open Anyway)  ->  klik die
      4. Bevestig nogmaals met  Open

   Zegt de Mac "je hebt niet de juiste toegangsrechten"?
   -> Open dan de app Terminal (via Spotlight: Cmd+spatie, typ Terminal)
      en plak daar deze twee regels (Enter na elke regel):
         chmod +x ~/Desktop/ClubPlanner-eID-Mac/installeer.command
         ~/Desktop/ClubPlanner-eID-Mac/installeer.command
      (pas het pad aan als de map niet op het Bureaublad staat)

   Er opent een zwart venster (Terminal). Wacht tot er "KLAAR!" verschijnt.

STAP 3 - Chrome herstarten
   Sluit Google Chrome VOLLEDIG af:
      Chrome-menu bovenaan  >  "Chrome afsluiten"   (of toets Cmd + Q)
   Start Chrome daarna opnieuw op.
   (Gewoon het venster sluiten is niet genoeg - het moet echt afsluiten.)

STAP 4 - Testen
   Steek de kaartlezer in, steek een eID in de lezer, en gebruik
   "eID lezen" in Club Planner. De gegevens moeten nu ingevuld worden.


WERKT HET NIET?
---------------
- Foutmelding "Could not establish connection" in Club Planner?
  Typ  chrome://extensions  in de adresbalk en controleer dat
  "Club Planner Extension" er staat EN dat het schuifje AAN staat (blauw).
  Staat de extensie er niet? Installeer ze via de Chrome Web Store
  (zoek op "Club Planner Extension").
- Controleer of de kaartlezer in een USB-poort zit en of er een kaart in zit.
- Heb je Chrome echt volledig afgesloten (Cmd + Q) en heropend?
- Herhaal STAP 2 en let goed op de "rechtermuisklik > Open"-tip.
- Blijft het misgaan? Contacteer Kristof (Club Planner) met een schermfoto.


========================================================
 Kort samengevat:
   1. Map naar Bureaublad kopieren
   2. installeer.command dubbelklikken (evt. rechtermuisklik > Open)
   3. Chrome afsluiten met Cmd+Q en heropenen
   4. eID insteken en testen
========================================================
